3D Graphics Programming with QuickDraw 3D 1.5.4

Getting Errors, Warnings, and Notices Directly

The Error Manager provides routines that you can use to retrieve an error, warning, or notice directly.

You should use these routines only if you have not already registered an error-, warning-, or notice-handling callback routine.

These routines return the following types, the values of which are enumerated in the header file QD3DErrors.h :

TQ3Error TQ3Warning TQ3Notice

Q3Error_Get

You can use the Q3Error_Get function to get the most recent and the oldest unreported errors from a QuickDraw 3D routine.



 
TQ3Error Q3Error_Get (TQ3Error *firstError);

firstError: On exit, the first unreported error from a QuickDraw 3D routine. Set this parameter to NULL if you do not want the first unreported error to be returned to you.

DESCRIPTION

The Q3Error_Get function returns, as its function result, the code of the most recent error that occurred after one or more previous calls to any QuickDraw 3D routines. Q3Error_Get causes QuickDraw 3D to clear that error code when you next call any QuickDraw 3D routine other than Q3Error_Get itself. Q3Error_Get also returns, in the firstError parameter, the oldest unreported error that occurred during a QuickDraw 3D routine.

Q3Warning_Get

You can use the Q3Warning_Get function to get the most recent and the oldest unreported warnings from a QuickDraw 3D routine.



 
TQ3Warning Q3Warning_Get (TQ3Warning *firstWarning);

firstWarning: On exit, the first unreported warning from a QuickDraw 3D routine. Set this parameter to NULL if you do not want the first unreported warning to be returned to you.

DESCRIPTION

The Q3Warning_Get function returns, as its function result, the code of the most recent warning that occurred after one or more previous calls to any QuickDraw 3D routines. Q3Warning_Get causes QuickDraw 3D to clear that warning code when you next call any QuickDraw 3D routine other than Q3Warning_Get itself. Q3Warning_Get also returns, in the firstWarning parameter, the last unreported warning that occurred during a QuickDraw 3D routine.

Q3Notice_Get

You can use the Q3Notice_Get function to get the most recent and the oldest unreported notice from a QuickDraw 3D routine.



 
TQ3Notice Q3Notice_Get (TQ3Notice *firstNotice);

firstNotice: On exit, the first unreported notice from a QuickDraw 3D routine. Set this parameter to NULL if you do not want the first unreported notice to be returned to you.

DESCRIPTION

The Q3Notice_Get function returns, as its function result, the code of the most recent notice that occurred after one or more previous calls to any QuickDraw 3D routines. Q3Notice_Get causes QuickDraw 3D to clear that notice code when you next call any QuickDraw 3D routine other than Q3Notice_Get itself. Q3Notice_Get also returns, in the firstNotice parameter, the last unreported notice that occurred during a QuickDraw 3D routine.

Notices are returned only by the debugging version of the QuickDraw 3D shared library.